home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / g_man / cat3 / standard / circf.z / circf
Encoding:
Text File  |  1998-10-20  |  4.8 KB  |  133 lines
  1.  
  2.  
  3.  
  4. cccciiiirrrrccccffff((((3333GGGG))))                                                            cccciiiirrrrccccffff((((3333GGGG))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      cccciiiirrrrccccffff,,,, cccciiiirrrrccccffffiiii,,,, cccciiiirrrrccccffffssss - draws a filled circle
  10.  
  11. CCCC SSSSPPPPEEEECCCCIIIIFFFFIIIICCCCAAAATTTTIIIIOOOONNNN
  12.      vvvvooooiiiidddd cccciiiirrrrccccffff((((xxxx,,,, yyyy,,,, rrrraaaaddddiiiiuuuussss))))
  13.      CCCCoooooooorrrrdddd xxxx,,,, yyyy,,,, rrrraaaaddddiiiiuuuussss;;;;
  14.  
  15.      vvvvooooiiiidddd cccciiiirrrrccccffffiiii((((xxxx,,,, yyyy,,,, rrrraaaaddddiiiiuuuussss))))
  16.      IIIIccccoooooooorrrrdddd xxxx,,,, yyyy,,,, rrrraaaaddddiiiiuuuussss;;;;
  17.  
  18.      vvvvooooiiiidddd cccciiiirrrrccccffffssss((((xxxx,,,, yyyy,,,, rrrraaaaddddiiiiuuuussss))))
  19.      SSSSccccoooooooorrrrdddd xxxx,,,, yyyy,,,, rrrraaaaddddiiiiuuuussss;;;;
  20.  
  21.      The routines above are functionally the same even though the type
  22.      declarations for the coordinates differ.
  23.  
  24. PPPPAAAARRRRAAAAMMMMEEEETTTTEEEERRRRSSSS
  25.      _x        expects the x coordinate of the center of the filled circle
  26.               specified in world coordinates.
  27.  
  28.      _y        expects the y coordinate of the center of the filled circle
  29.               specified in world coordinates.
  30.  
  31.      _r_a_d_i_u_s   expects the length of the radius of the filled circle.
  32.  
  33. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  34.      cccciiiirrrrccccffff draws a filled circle in the _x-_y plane (_z = _0).  To draw a circle
  35.      in a plane other than the _x-_y plane, define the circle in the _x-_y plane
  36.      and then rotate or translate the circle. Note that filled circles rotated
  37.      outside the 2-D _x-_y plane appear as filled ellipses.
  38.  
  39.      A circle is drawn as a single polygon, and therefore inherits all
  40.      properties that affect the drawing of polygons.  These include the
  41.      current color, writemask, fill pattern, shade model, polygon antialiasing
  42.      mode, polygon scan conversion mode, and subpixel mode.  Front-face and
  43.      back-face elimination work correctly with filled circles, which are
  44.      front-facing when viewed from the positive z half-space.  Some polygon
  45.      modes are applicable only if old-style scan conversion is defeated.  (See
  46.      note below.)
  47.  
  48.      After cccciiiirrrrccccffff executes, the graphics position is undefined.
  49.  
  50. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  51.      arcf, backface, bgnpolygon, circ, frontface, glcompat, polymode,
  52.      polysmooth, scrsubdivide, setpattern, shademodel, subpixel
  53.  
  54. NNNNOOOOTTTTEEEESSSS
  55.      By default cccciiiirrrrccccffff draws a polygon using the old-style scan conversion
  56.      algorithm, rather than the point sampling algorithm used by bbbbggggnnnnppppoooollllyyyyggggoooonnnn
  57.      and eeeennnnddddppppoooollllyyyyggggoooonnnn.  Point sampling is preferred over old-style scan
  58.      conversion because it has higher performance, it results in higher-
  59.      quality images when blending, logical operations, or stenciling are used,
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. cccciiiirrrrccccffff((((3333GGGG))))                                                            cccciiiirrrrccccffff((((3333GGGG))))
  71.  
  72.  
  73.  
  74.      and it supports new rendering features such as texture mapping, fog, and
  75.      antialiasing.  Call ggggllllccccoooommmmppppaaaatttt((((GGGGLLLLCCCC____OOOOLLLLDDDDPPPPOOOOLLLLYYYYGGGGOOOONNNN,,,,0000)))) to enable point sampling
  76.      of polygons generated by cccciiiirrrrccccffff.
  77.  
  78.      The identifier of the function cccciiiirrrrccccffff declared in gl/gl.h conflicts with
  79.      the identifier of the external variable circf declared in regexp.h.  If
  80.      you need to include gl/gl.h and regexp.h in the same source file, embed
  81.      the "#include <regexp.h>" statement, and all references to the variable
  82.      circf in the source file, with a "#define circf re_circf" and "#undef
  83.      re_circf" pair of statements.
  84.  
  85.  
  86.  
  87.  
  88.  
  89.  
  90.  
  91.  
  92.  
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.